Release 10.1A: OpenEdge Development:
Progress 4GL Reference

LOAD-IMAGE-INSENSITIVE( ) method

Reads the image contained in specified file. The image is used for the button in its insensitive state.

Return type: LOGICAL

Applies to: BUTTON widget

Syntax

LOAD-IMAGE-INSENSITIVE ( filename [ , x-offset , y-offset , width , height ] )

filename

A character-string expression that specifies a full or relative pathname for a file that contains an image to display in a button when the button is insensitive.

x-offset

An integer expression that specifies the pixel along the x-axis at which to begin reading from the image file.

y-offset

An integer expression that specifies the pixel along the y-axis at which to begin reading from the image file.

width

An integer expression that specifies the number of pixels along the x-axis to read from the image file.

height

An integer expression that specifies the number of pixels along the y-axis to read from the image file.

Notes

If this image is not loaded, the appearance of the button up image does not change between the button’s sensitive and insensitive state; if no image is loaded, the button label is grayed out in its insensitive state.
The image is not displayed until the widget is realized. If the read is successful, the method returns TRUE.
In Windows, you can specify a URL pathname. If you specify a fully-qualified URL, LOAD-IMAGE-INSENSITIVE loads the image file directly without searching directories or URLs in PROPATH. Valid URL protocols include HTTP and HTTPS.
Note: URL pathnames cannot contain the percent symbol (%). If an error exists in a URL specified on the PROPATH, the LOAD-IMAGE-INSENSITIVE method continues searching with the next PROPATH entry.
If you specify URL pathnames on the PROPATH and your application repeatedly uses the LOAD-IMAGE-INSENSITIVE method with a URL pathname, you can improve performance by using the SEARCH function once to determine the full URL pathname to the directory containing the image files. Use this value to create a fully-qualified URL pathname for filename and avoid repeated searches of the PROPATH.